home *** CD-ROM | disk | FTP | other *** search
/ SPACE 1 / SPACE - Library 1 - Volume 1.iso / misc~1 / 123 / stcitdoc.arc / ARCHIVE.DOC < prev    next >
Encoding:
Text File  |  1987-09-10  |  3.8 KB  |  81 lines
  1. ARCHIVE.DOC
  2.  
  3.     An interest has been expressed recently in giving Citadel the
  4. ability to automatically maintain, in some way, a record of
  5. conversations that are held.  This has been motivated by the
  6. CitaBook project, story-telling, and other subjects that have, for
  7. one reason or another, given the system operator reason to pause,
  8. think, and wish to save those messages in a far more permanent form
  9. than as a Citadel message, which will inevitably scroll.
  10.  
  11.     The first attempt at such an ability was the EXTRACT utility. 
  12. Crappily written, an awkward user interface, and being an
  13. independent utility all contributed to it being spat upon by all who
  14. used it (including the author).
  15.  
  16.     The second attempt, which is itself recent as of this date, was
  17. essentially the integration of EXTRACT into CTDL.EXE.  This feature
  18. was restricted to aides at the sysConsole, and was accessed in a way
  19. similar to the manner in which messages are deleted.  The aide would
  20. hit <P>ause during the printout of the message to be extracted. 
  21. Then the aide would hit J, for Journal, to restart the message (to
  22. Delete a message, the aide would hit D).  At the end of the message,
  23. Citadel would ask for the file to store the message under. This is
  24. (I think) a very useful ability, and seems to work well.
  25.  
  26.     Still, it boils down to a lot of manual labor; it's only
  27. convenient for single messages.  What if the sysop wants to record
  28. an entire room on disk, on an ongoing basis?
  29.  
  30.     Therefore, Citadel now has the ability to maintain just such a
  31. textfile on disk. Called (for the time being) the Archive feature,
  32. it allows the sysop to designate virtually any room to be an Archive
  33. room. Such a room then will have a filename associated with it. 
  34. Within the file of that name, each and every message that is entered
  35. into that room will also be appended to a archive file.
  36.  
  37.  PROCEDURE:
  38.     The procedure to designate a room as Archive is to simply edit
  39. the room (note that this automatically excludes Aide>, Mail>, and
  40. the baseRoom as Archive rooms).  One of the questions that you will
  41. encounter will concern Archive status of the room. If you answer yes,
  42. the system will do one of two things:
  43.  
  44.  A) If the room was not an Archive room before, it'll ask for a
  45. filename to associate with the room.
  46.  B) If it was already an Archive room, it'll just assume that the
  47. filename should remain the same, and not bother you further about
  48. Archive stuff.
  49.  
  50.     If it does ask for filename, the filename that you should type
  51. in can be located anywhere in the system that you desire.  Once you
  52. have typed it in, Citadel will attempt to archive all the messages
  53. that are currently in the room (message numbers will be spewed out
  54. at this point to reassure you that there is* method in Citadel's
  55. madness).
  56.  
  57.     An Archive room puts each new message into the Archive file when
  58. it is initially entered into the room (note that Aide actions, such
  59. as deleting the message later, does not affect the Archive file).
  60.  
  61.  CONSIDERATIONS:
  62.     This feature is recommended only for high-performance systems,
  63. particularly those with fairly fast hard disks, since each message
  64. is, in effect, saved twice.  Furthermore, since active rooms will
  65. result in very fast file growth, close tabs should be kept on disk
  66. free space by the sysop.
  67.  
  68.  NOTES:
  69.     This is all Torkildson's fault.
  70.     The filenames are stored in the new .SYS file CTDLARCH.SYS file.
  71. This file is unique in the respect that it is a human readable text
  72. file. Each Archive room on the system will have an entry in this file,
  73. in the following format:
  74.  
  75.  <room#><space><full-filespec>
  76.  
  77.     Thus, if the sysop wants to modify what file to store the
  78. Archive data in without going through the hassle of editing the room
  79. twice (see above), s/he can whip out their handy-dandy text editor,
  80. and fix it right then and there.
  81.